home *** CD-ROM | disk | FTP | other *** search
- <?xml version="1.0" encoding="iso-2022-jp"?>
- <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
- <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
- <!-- English Revision: 1.12.2.9 -->
-
- <!--
- Copyright 2002-2004 The Apache Software Foundation
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
-
- <modulesynopsis metafile="mod_deflate.xml.meta">
-
- <name>mod_deflate</name>
- <description>$B%/%i%$%"%s%H$XAw$i$l$kA0$K%3%s%F%s%D$r05=L$9$k(B</description>
- <status>Extension</status>
- <sourcefile>mod_deflate.c</sourcefile>
- <identifier>deflate_module</identifier>
-
- <summary>
- <p><module>mod_deflate</module> $B%b%8%e!<%k$O(B <code>DEFLATE</code>
- $B=PNO%U%#%k%?$rDs6!$7$^$9!#$3$l$O%5!<%P$+$i$N=PNO$r!"%M%C%H%o!<%/$r(B
- $BDL$7$F%/%i%$%"%s%H$KAw$kA0$K05=L$9$k$3$H$r2DG=$K$7$^$9!#(B</p>
- </summary>
- <seealso><a href="../filter.html">Filters</a></seealso>
-
- <section id="recommended"><title>$B%5%s%W%k@_Dj(B</title>
- <p>$B2<$K$;$C$+$A$J?M8~$1$N4JC1$J@_DjNc$r<($7$^$9!#(B</p>
-
- <example><title>$B?t%?%$%W$N$_05=L$9$k(B</title>
- AddOutputFilterByType DEFLATE text/html text/plain text/xml
- </example>
-
- <p>$B0J2<$N@_Dj$O%3%s%F%s%D$r$h$j05=L$7$^$9$,!"$:$C$HJ#;($J@_Dj$K$J$j$^$9!#(B
- $B@_Dj$N6y!9$^$G$h$/M}2r$7$J$$$G;H$o$J$$$G$/$@$5$$!#(B</p>
-
- <example><title>$B2hA|0J30A4$F05=L$9$k(B</title>
- <Location /><br />
- <indent>
- # Insert filter<br />
- SetOutputFilter DEFLATE<br />
- <br />
- # Netscape 4.x has some problems...<br />
- BrowserMatch ^Mozilla/4 gzip-only-text/html<br />
- <br />
- # Netscape 4.06-4.08 have some more problems<br />
- BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
- <br />
- # MSIE masquerades as Netscape, but it is fine<br />
- # BrowserMatch \bMSIE !no-gzip !gzip-only-text/html<br />
- <br />
- # NOTE: Due to a bug in mod_setenvif up to Apache 2.0.48<br />
- # the above regex won't work. You can use the following<br />
- # workaround to get the desired effect:<br />
- BrowserMatch \bMSI[E] !no-gzip !gzip-only-text/html<br />
- <br />
- # Don't compress images<br />
- SetEnvIfNoCase Request_URI \<br />
- <indent>
- \.(?:gif|jpe?g|png)$ no-gzip dont-vary<br />
- </indent>
- <br />
- # Make sure proxies don't deliver the wrong content<br />
- Header append Vary User-Agent env=!dont-vary<br />
- </indent>
- </Location>
- </example>
-
- </section>
-
- <section id="enable"><title>$B05=L$rM-8z$K$9$k(B</title>
-
- <section id="output"><title>Output Compression</title>
- <p>$B05=L5!G=$O(B <code>DEFLATE</code> <a href="../filter.html">$B%U%#%k%?(B</a>
- $B$K$h$j<BAu$5$l$F$$$^$9!#0J2<$N%G%#%l%/%F%#%V$O$=$N%G%#%l%/%F%#%V$N$"$k(B
- $B%3%s%F%JCf$N%I%-%e%a%s%H$r05=L$9$k$h$&$K$7$^$9(B:</p>
-
- <example>
- SetOutputFilter DEFLATE
- </example>
-
- <p>$B$h$/;H$o$l$F$$$k%V%i%&%6$G$O!"$9$Y$F$N%3%s%F%s%D$KBP$9$k(B
- $B05=L$r07$($k$o$1$G$O$"$j$^$;$s!#$G$9$+$i!"(B<code>gzip-only-text/html</code>
- $B%N!<%H$r(B <code>1</code> $B$K$7$F!"(Bhtml $B%U%!%$%k$KBP$7$F$N$_(B
- $B05=L$,F/$/$h$&$K$7$?J}$,$h$$$+$b$7$l$^$;$s(B ($B0J2<;2>H(B)
- $B$3$NCM$r(B <em><code>1</code> $B0J30$NCM(B</em>$B$K@_Dj$7$?>l9g$OL5;k$5$l$^$9!#(B</p>
-
- <p>$BDL>o!"FCDj$N(BMIME$B%?%$%W$K$D$$$F$N$_05=L$7$?$$$N$G$"$l$P!"(B
- <directive module="core">AddOutputFilterByType</directive>
- $B%G%#%l%/%F%#%V$r;HMQ$7$^$9!#<!$K(B Apache $B$N%I%-%e%a%s%H$N(B html
- $B%U%!%$%k$N$_$N05=L$rM-8z$K$9$kNc$r<($7$^$9!#(B</p>
-
- <example>
- <Directory "/your-server-root/manual"><br />
- <indent>
- AddOutputFilterByType DEFLATE text/html<br />
- </indent>
- </Directory>
- </example>
-
- <p>$BA4$F$N%U%!%$%k%?%$%W$G$N05=L$KLdBj$rJz$($F$$$k%V%i%&%6$KBP$7$F$O!"(B
- <directive module="mod_setenvif">BrowserMatch</directive>
- $B%G%#%l%/%F%#%V$r;HMQ$7$F!"FCDj$N%V%i%&%6$K(B <code>no-gzip</code>
- $B%N!<%H$r%;%C%H$7!"05=L$,9T$J$o$l$J$$$h$&$K$7$^$9!#(B
- <code>no-gzip</code> $B$H(B <code>gzip-only-text/html</code>
- $B$rAH$_9g$o$;$k$3$H$G>e<j$/BP=h$G$-$^$9!#(B
- $B$3$N>l9g!"A0<T$,8e<T$r%*!<%P!<%i%$%I$7$^$9!#(B
- $B>e5-$N(B<a href="#recommended">$B@_DjNc(B</a>$B$NH4?h$r(B
- $B<!$K<($7$^$9$N$G$4Mw2<$5$$!#(B</p>
-
- <example>
- BrowserMatch ^Mozilla/4 gzip-only-text/html<br />
- BrowserMatch ^Mozilla/4\.0[678] no-gzip<br />
- BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
- </example>
-
- <p>$B$^$:;O$a$K(B <code>User-Agent</code> $BJ8;zNs$+$i(B Netscape Navigator
- 4.x $B$G$"$k$+$I$&$+$rD4$Y$^$9!#$3$l$i$N%P!<%8%g%s$G$O!"(B
- <code>text/html</code> $B0J30$N%?%$%W$N05=L$r07$&$3$H$,$G$-$^$;$s!#(B
- 4.06, 4.07, 4.08 $B$O(B html $B%U%!%$%k$N?-D%$K$bLdBj$rJz$($F$$$^$9!#(B
- $B$G$9$+$i$3$l$i$KBP$7$F$O!"40A4$K(B deflate $B%U%#%k%?$r%*%U$K$7$^$9!#(B</p>
-
- <p>3 $BHVL\$N(B <directive module="mod_setenvif">BrowserMatch</directive>
- $B%G%#%l%/%F%#%V$G!"?dB,$7$?%f!<%6!<%(!<%8%'%s%H$r=$@5$7$^$9!#(B
- $B$J$<$J$i(B Microsoft Internet Explorer $B$b(B "Mozilla/4" $B$HFCDj$5$l$^$9$,!"(B
- $B$3$l$i$O<B:]$K$O05=L$r07$&$3$H$,$G$-$k$+$i$G$9!#(B
- <code>User-Agent</code> $B%X%C%@$r(B "MSIE"
- (<code>\b</code> $B$O!VC18l$N6-3&!W$r0UL#$7$^$9(B) $B$NDI2CJ8;z$G8!::$7$F!"(B
- $B$3$l0JA0$K@_Dj$7$?@)8B$r:F$S2r=|$7$^$9!#(B</p>
-
- <note><title>$BCm(B</title>
- <code>DEFLATE</code> $B%U%#%k%?$OI,$:!"(BPHP $B$d(B SSI $B$H$$$C$?(B RESOURCE
- $B%U%#%k%?$N8e$K$J$j$^$9!#(B
- DEFLATE $B%U%#%k%?$OFbItE*$J%5%V%j%/%(%9%H$r4XCN$7$^$;$s!#(B
- </note>
-
- </section>
-
- <section id="input"><title>$BF~NO$N?-D%(B</title>
- <p><module>mod_deflate</module> $B%b%8%e!<%k$O!"(Bgzip
- $B$G05=L$5$l$?%j%/%(%9%HK\BN$r?-D%$9$k%U%#%k%?$bDs6!$7$F$$$^$9!#(B
- $B$3$N5!G=$rM-8z$K$9$k$K$O!"(B<directive module="core">SetInputFilter</directive>
- $B$+(B <directive module="mod_mime">AddInputFilter</directive> $B$r;HMQ$7$F!"(B
- <code>DEFLATE</code> $B%U%#%k%?$rF~NO%U%#%k%?%A%'%$%s$KAH$_9~$_$^$9!#(B
- $BNc$($P<!$N$h$&$K$J$j$^$9!#(B</p>
-
- <example>
- <Location /dav-area><br />
- <indent>
- SetInputFilter DEFLATE<br />
- </indent>
- </Location>
- </example>
-
- <p>$B$3$N@_Dj$G$"$l$P!"(B<code>Content-Encoding: gzip</code>
- $B%X%C%@$r4^$`%j%/%(%9%H$,Mh$k$H!"K\BN$O<+F0E*$K?-D%$5$l$^$9!#(B
- gzip $B%j%/%(%9%HK\BN$rAw?.$9$k%V%i%&%6$O$"$^$j$"$j$^$;$s!#(B
- $B$7$+$7!"Nc$($P(B <a href="http://www.webdav.org">WebDAV</a>
- $B%/%i%$%"%s%H$N4v$D$+$J$I!"FCJL$J%"%W%j%1!<%7%g%s$G%j%/%(%9%H$N(B
- $B05=L$r<B:]$K%5%]!<%H$7$F$$$k$b$N$b$"$j$^$9!#(B</p>
-
- <note type="warning"><title>Content-Length $B$K4X$9$kCm0U(B</title>
- <p>$B%j%/%(%9%HK\BN$=$l<+BN$rI>2A$9$k>l9g$O!"(B<em><code>Content-Length</code>
- $B%X%C%@$r?.MQ$7$J$$$G$/$@$5$$(B</em>$B!#(BContent-Length $B%X%C%@$O!"(B
- $B%/%i%$%"%s%H$+$iAw?.$5$l$k%G!<%?$ND9$5$rH?1G$7$F$$$k$N$G$"$C$F!"(B
- $B?-D%$5$l$?%G!<%?%9%H%j!<%`$N(B<em>$B%P%$%H%+%&%s%H$G$O$"$j$^$;$s(B</em>$B!#(B</p>
- </note>
- </section>
- </section>
-
- <section id="proxies"><title>Proxy $B%5!<%P$G$N07$$(B</title>
-
- <p><module>mod_deflate</module> $B%b%8%e!<%k$O(B <code>Vary: Accept-Encoding</code>
- HTTP $B1~Ez%X%C%@$rAw?.$7$F!"E,@Z$J(B <code>Accept-Encoding</code>
- $B%j%/%(%9%H%X%C%@$rAw?.$9$k%/%i%$%"%s%H$KBP$7$F$N$_!"(B
- $B%W%m%/%7%5!<%P$,%-%c%C%7%e$7$?1~Ez$rAw?.$9$k$h$&$KCm0U$r4-5/$7$^$9!#(B
- $B$3$N$h$&$K$7$F!"05=L$r07$&$3$H$N$G$-$J$$%/%i%$%"%s%H$K(B
- $B05=L$5$l$?FbMF$,Aw$i$l$k$3$H$N$J$$$h$&$K$7$^$9!#(B</p>
-
- <p>$B$b$7FCJL$K2?$+$K0MB8$7$F=|30$7$?$$>l9g!"Nc$($P(B <code>User-Agent</code>
- $B%X%C%@$J$I$K0MB8$7$F$$$k>l9g!"<jF0$G(B <code>Vary</code> $B%X%C%@$r@_Dj$7$F!"(B
- $BDI2C$N@)8B$K$D$$$F%W%m%/%7%5!<%P$KCm0U$r9T$J$&I,MW$,$"$j$^$9!#(B
- $BNc$($P(B <code>User-Agent</code> $B$K0MB8$7$F(B <code>DEFLATE</code>
- $B$rDI2C$9$kE57?E*$J@_Dj$G$O!"<!$N$h$&$KDI2C$9$k$3$H$K$J$j$^$9!#(B</p>
-
- <example>
- Header append Vary User-Agent
- </example>
-
- <p>$B%j%/%(%9%H%X%C%@0J30$N>pJs(B (<em>$BNc$($P(B</em> HTTP $B%P!<%8%g%s(B)
- $B$K0MB8$7$F05=L$9$k$+$I$&$+7h$a$k>l9g!"(B
- <code>Vary</code> $B%X%C%@$r(B <code>*</code> $B$K@_Dj$9$kI,MW$,$"$j$^$9!#(B
- $B$3$N$h$&$K$9$k$H!";EMM$K=`5r$7$?%W%m%/%7$O%-%c%C%7%e$rA4$/9T$J$o$J$/$J$j$^$9!#(B</p>
-
- <example><title>$BNc(B</title>
- Header set Vary *
- </example>
- </section>
-
- <directivesynopsis>
- <name>DeflateFilterNote</name>
- <description>$B%m%.%s%0MQ$K05=LHf$r%a%b$KDI2C(B</description>
- <syntax>DeflateFilterNote [<var>type</var>] <var>notename</var></syntax>
- <contextlist><context>server config</context>
- <context>virtual host</context></contextlist>
- <compatibility><var>type</var> is available since Apache 2.0.45</compatibility>
-
- <usage>
- <p><directive>DeflateFilterNote</directive> $B%G%#%l%/%F%#%V$O(B
- $B05=LHf$K4X$9$k%a%b$,%j%/%(%9%H$KIU2C$5$l$k$3$H$r;XDj$7$^$9!#(B
- $B%a%b(B (note) $B$NL>A0$O%G%#%l%/%F%#%V$K;XDj$5$l$?CM$G$9!#(B
- $B%a%b$O(B<a href="../logs.html#accesslog">$B%"%/%;%9%m%0(B</a>$B$K(B
- $BCM$r5-O?$7!"E}7W$r<h$kL\E*$K$b;H$($^$9!#(B</p>
-
- <example><title>$BNc(B</title>
- DeflateFilterNote ratio<br />
- <br />
- LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate<br />
- CustomLog logs/deflate_log deflate
- </example>
-
- <p>$B%m%0$+$i$b$C$H@:L)$JCM$rCj=P$7$?$$>l9g$O!"(B<var>type</var>
- $B0z?t$r;HMQ$7$F!"%G!<%?%?%$%W$r%m%0$N%a%b$H$7$F;D$9$h$&$K;XDj$G$-$^$9!#(B
- <var>type</var> $B$O<!$N$&$A$N0l$D$G$9!#(B</p>
-
- <dl>
- <dt><code>Input</code></dt>
- <dd>$B%U%#%k%?$NF~NO%9%H%j!<%`$N%P%$%H%+%&%s%H$r%a%b$KJ]B8$9$k!#(B</dd>
-
- <dt><code>Output</code></dt>
- <dd>$B%U%#%k%?$N=PNO%9%H%j!<%`$N%P%$%H%+%&%s%H$r%a%b$KJ]B8$9$k!#(B</dd>
-
- <dt><code>Ratio</code></dt>
- <dd>$B05=LN((B (<code>$B=PNO(B / $BF~NO(B * 100</code>) $B$r%a%b$KJ]B8$9$k!#(B
- <var>type</var> $B0z?t$r>JN,$7$?>l9g$O!"$3$l$,%G%U%)%k%H$H$J$j$^$9!#(B</dd>
- </dl>
-
- <p>$B$^$H$a$k$H!"<!$N$h$&$K%m%0$r<h$k$3$H$K$J$k$G$7$g$&!#(B</p>
-
- <example><title>$B@:L)$J%m%0:N<h(B</title>
- DeflateFilterNote Input instream<br />
- DeflateFilterNote Output outstream<br />
- DeflateFilterNote Ratio ratio<br />
- <br />
- LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate<br />
- CustomLog logs/deflate_log deflate
- </example>
- </usage>
- <seealso><module>mod_log_config</module></seealso>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>DeflateBufferSize</name>
- <description>zlib $B$,0lEY$K05=L$9$k2t$NBg$-$5(B</description>
- <syntax>DeflateBufferSize <var>value</var></syntax>
- <default>DeflateBufferSize 8096</default>
- <contextlist><context>server config</context>
- <context>virtual host</context></contextlist>
-
- <usage>
- <p><directive>DeflateBufferSize</directive> $B%G%#%l%/%F%#%V$O(B
- zlib $B$,0lEY$K05=L$9$k2t$NBg$-$5$r%P%$%HC10L$G;XDj$7$^$9!#(B</p>
- </usage>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>DeflateWindowSize</name>
- <description>Zlib $B$N05=LMQ%&%#%s%I%&$NBg$-$5(B</description>
- <syntax>DeflateWindowSize <var>value</var></syntax>
- <default>DeflateWindowSize 15</default>
- <contextlist><context>server config</context>
- <context>virtual host</context></contextlist>
-
- <usage>
- <p><directive>DeflateWindowSize</directive> $B%G%#%l%/%F%#%V$O(B
- zlib $B$N05=LMQ%&%#%s%I%&(B ($BLuCm(B: zlib $B$G;HMQ$5$l$kMzNr%P%C%U%!(B)
- $B$NBg$-$5$r;XDj$7$^$9(B (1 $B$+$i(B 15 $B$N4V$NCM(B)$B!#(B
- $B0lHLE*$KBg$-$J%&%#%s%I%&%5%$%:$r;HMQ$9$k$H05=LN($,8~>e$7$^$9!#(B
- ($BLuCm(B: 2 $B$rDl$H$9$kBP?t$NCM$K$J$j$^$9!#(B
- 8 $B$+$i(B 15 $B$K$9$k$N$,NI$$$G$7$g$&!#(B)</p>
- </usage>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>DeflateMemLevel</name>
- <description>zlib $B$,05=L$K;H$&%a%b%j$N%l%Y%k$r;XDj(B</description>
- <syntax>DeflateMemLevel <var>value</var></syntax>
- <default>DeflateMemLevel 9</default>
- <contextlist><context>server config</context>
- <context>virtual host</context></contextlist>
-
- <usage>
- <p><directive>DeflateMemLevel</directive> $B%G%#%l%/%F%#%V$O(B
- zlib $B$,05=L$K;H$&%a%b%j$N%l%Y%k$r@_Dj$7$^$9(B (1 $B$+$i(B 9 $B$N4V$NCM(B)$B!#(B
- ($BLuCm(B: 2 $B$rDl$H$9$kBP?t$NCM$K$J$j$^$9!#(B
- 8 $BDxEY$,NI$$$G$7$g$&!#(B)</p>
- </usage>
- </directivesynopsis>
-
- <directivesynopsis>
- <name>DeflateCompressionLevel</name>
- <description>$B=PNO$KBP$7$F9T$J$&05=L$NDxEY(B</description>
- <syntax>DeflateCompressionLevel <var>value</var></syntax>
- <default>Zlib $B$N%G%U%)%k%H(B</default>
- <contextlist><context>server config</context><context>virtual host</context>
- </contextlist>
- <compatibility>This directive is available since Apache 2.0.45</compatibility>
-
- <usage>
- <p><directive>DeflateCompressionLevel</directive> $B%G%#%l%/%F%#%V$O(B
- $B05=L$NDxEY$r@_Dj$7$^$9!#Bg$-$JCM$G$O!"$h$j05=L$,9T$J$o$l$^$9$,!"(B
- CPU $B;q8;$r>CHq$7$^$9!#(B</p>
- <p>$BCM$O(B 1 ($BDc05=L(B) $B$+$i(B 9 ($B9b05=L(B) $B$G$9!#(B</p>
- </usage>
- </directivesynopsis>
-
- </modulesynopsis>
-
-